package com.outdoor.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.outdoor.model.entity.User;

import java.util.List;

/**
 * 用户服务接口
 * 
 * @author OutdoorTeam
 * @date 2025-05-18
 */
public interface UserService {

    /**
     * 创建新用户
     * 
     * @param user 用户信息
     * @return 创建后的用户
     */
    User createUser(User user);

    /**
     * 根据ID查找用户
     * 
     * @param id 用户ID
     * @return 用户信息
     */
    User getUserById(Long id);

    /**
     * 根据多个ID批量获取用户
     * 
     * @param ids 用户ID列表
     * @return 用户列表
     */
    List<User> getUsersByIds(List<Long> ids);

    /**
     * 根据用户名查找用户
     * 
     * @param username 用户名
     * @return 用户信息
     */
    User getUserByUsername(String username);

    /**
     * 更新用户信息
     * 
     * @param id 用户ID
     * @param user 更新的用户信息
     * @return 更新后的用户
     */
    User updateUser(Long id, User user);

    /**
     * 删除用户
     * 
     * @param id 用户ID
     */
    void deleteUser(Long id);

    /**
     * 获取用户列表
     * 
     * @param page 分页对象
     * @return 用户分页列表
     */
    IPage<User> listUsers(Page<User> page);

    /**
     * 增加用户参与行程数
     * 
     * @param userId 用户ID
     */
    void incrementTripsCount(Long userId);
    
    /**
     * 将兴趣爱好字符串转为列表
     * 
     * @param interests 兴趣爱好字符串
     * @return 兴趣爱好列表
     */
    List<String> getInterestsList(String interests);
    
    /**
     * 将装备字符串转为列表
     * 
     * @param equipment 装备字符串
     * @return 装备列表
     */
    List<String> getEquipmentList(String equipment);
    
    /**
     * 将列表转为逗号分隔的字符串
     * 
     * @param list 字符串列表
     * @return 逗号分隔字符串
     */
    String listToString(List<String> list);
} 